This page refers to an older version of the product.
View the current version of the online Help.

 

EMP Registry Utility

About the EMP Registry Utility

The Environment Manager Personalization Utility (EMP Registry Utility) is a command-line utility that can import and export REG files to and from an Environment Manager personalization database. It also includes a function to delete keys. The REG files are in the same format used by the Microsoft RegEdit utility. All functions apply to a single application for a single user.

Requirements

A username and password of a user with access to the database tables is required because the utility accesses the database directly. Using the Personalization service account will not work.

Windows Settings Group Support

The registry utility can be used to import and export registry setting files from Windows Settings groups contained in the parent “Windows Settings” profile. To do this the application name is replaced by the Windows Setting group name prefixed by “wsg:”. So to import and export from the Windows Setting group named “Appearance and Personalization”, specify “wsg:Appearance and Personalization” as the application name.

Usage Scenario

A typical scenario is when a user or group requires that a certain registry key is updated through a batch process rather than via a user interface. The EMP Registry Utility can also be used in conjunction with Environment Manager Policy Configuration to directly manipulate the users settings within the database.

Define a Connection String for the Database

A valid connection string to the database must be defined in the environment variable EMPFileUtilConnectionString in the same command window that EMPRegUtil is run. This procedure shows how to set the environment variable and subsequently run the utility.

  1. Select Start > AppSense > Environment Manager > Tools > EMP Registry Utility .
  2. On the command line, enter SET EMPRegUtilConnectionString=<connection string>.

    For example, SET EMPRegUtilConnectionString=Data Source=(local);Initial Catalog=PersonalizationServer;Integrated Security=SSPI

  3. Press Enter.
  4. This environment variable can also be set globally in the System Properties.
  5. On the command line, enter EMPRegUtil followed by the command and parameters for the required function:
    • EXPORT <user> <group> <app> <key> <file>
    • IMPORT <user> <group> <app> <file>
    • DELETE <user> <group> <app> <key>
  6. For example: EMPRegUtil EXPORT domain1\smithj “Default Users” Outlook HKEY_CURRENT_USER\Software\Outlook Outlook.reg.
  7. Press Enter to perform the specified function.